home *** CD-ROM | disk | FTP | other *** search
/ CU Amiga Super CD-ROM 14 / CU Amiga Magazine's Super CD-ROM 14 (1997)(EMAP Images)(GB)(Track 1 of 3)[!][issue 1997-09].iso / CUCD / Utilities / Datatypes / qrtV43 / Readme < prev    next >
Text File  |  1997-07-03  |  3KB  |  88 lines
  1. qrtV43.datatype Version 43.1 (4-Jul-97)
  2. and fixed descriptor for qrt.datatype (qrtV39Fix).
  3.  
  4. Written by TetiSoft@apg.lahn.de (Detlef Wuerkner)
  5.  
  6. This is public domain.
  7.  
  8.  
  9. It's a datatype for PovRay dump format (QRT). V43 only, that means,
  10. it requires a 24-Bit picture.datatype (currently available for
  11. Cybergraphics and Picasso96). If your picture.datatype is an older
  12. version, don't worry, this package contains something that can
  13. be useful for you. See section qrtV39Fix below.
  14.  
  15.  
  16. qrtV43
  17. ------
  18. Mainly written to see if the samplePNM.datatype and source-code
  19. by Andreas R. Kleinert (V43.6 (27.3.97)) really work as easy as
  20. it seemed. They do ;-) Thanks to Andreas! It's code can be found
  21. on Aminet in dev/c/C_V43DT.lha. Let me cite him:
  22.  
  23.   You may e.g. use this example source code to write more portable
  24.   Amiga OS 3 datatypes to allow easier porting of these
  25.   to other Amiga OS-derived operating systems, or the native
  26.   OS of an upcoming PowerPC Amiga.
  27.  
  28. The file Source/Part_of_libfuncs.c contains the changed file
  29. decoding function, adopted for QRT format. The descriptor "QRT"
  30. uses the same hook-function as "qrtV39Fix/QRT". The source code
  31. for the hook-function can be found in Source/QRTCheck.c, the
  32. compiled binary is named Source/QRTCheck. When playing around with
  33. "dtdesc", you always must load the fuction Source/QRTCheck before
  34. saving, otherwise dtdesc won't remember it!
  35.  
  36.  
  37.  
  38. Installation of qrtV43:
  39. ----------------------
  40. If your picture.datatype has a lower version number than 43, don't
  41. install it, install qrtV39Fix instead!
  42.  
  43. Copy qrtV43.datatype to SYS:Classes/Datatypes/
  44. Copy QRT and QRT.info to devs:datatypes/
  45. Double-click the QRT-Icon
  46. Try to load "SamplePic" with MultiView to see if it works.
  47. It works? OK, than you don't need the following:
  48.  
  49.  
  50.  
  51. qrtV39Fix
  52. ---------
  53. In directory qrtV39Fix you will find a new descriptor for qrt.datatype
  54. 39.1 from billy@uni-paderborn.de (Michael Böhnisch), available on aminet
  55. as util/dtype/QRT_DT.lha, that works with older picture.datatypes.
  56. The new descriptor fixes the problem that many non-QRT-Files were
  57. recognized as QRT. It now uses a hook-Function that checks for the
  58. following (citing Michael, who did this tests in the datatype itself):
  59.  
  60.   · File  size  must  match  height  and  width information.  Partial files
  61.     written by PovRay are rejected.
  62.  
  63.   · Line  numbers  must  start  with 0 and increment to image height - 1 in
  64.     sorted  order.  QRT does not explicitly forbid arbitrary line order but
  65.     PovRay produces lines in sequence --- take it as a "feature", it really
  66.     makes file type detection easier and safer.
  67.  
  68. The source code for the hook-function can be found in Source/QRTCheck.c,
  69. the compiled binary is named Source/QRTCheck. When playing around with
  70. "dtdesc", you always must load the fuction QRTCheck before saving,
  71. otherwise dtdesc won't remember it!
  72.  
  73. Installation of qrtV39Fix:
  74. --------------------------
  75. If your picture.datatype has a version number of 43 or higher,
  76. why don't install qrtV43 instead? It would display in 24 bit depth
  77. instead of 8 bit!
  78.  
  79. To use the fixed descriptor, first install QRT_DT.lha, then copy
  80. qrtV39Fix/QRT#? to devs:datatypes/ and double-click on it. Try to load
  81. "SamplePic" with MultiView to see if it works.
  82.  
  83.  
  84. Happy datatyping, and send me an e-mail if this package is of use for you
  85. or if you have problems with it.
  86.  
  87. TetiSoft@apg.lahn.de (Detlef Wuerkner)
  88.